Http/AsyncTask

AsyncTask

  1. Params：开始异步任务执行时传入的参数类型；

  2. Progress：异步任务执行过程中，返回下载进度值的类型；

  3. Result：异步任务执行完成后，返回的结果类型；

    如果AsyncTask确定不需要传递具体参数，那么这三个泛型参数可以用Void来代替。

    核心方法

  4. onPreExecute()
    这个方法会在后台任务开始执行之间调用，在主线程执行。用于进行一些界面上的初始化操作，比如显示一个进度条对话框等。

  5. doInBackground(Params…)
    这个方法中的所有代码都会在子线程中运行，我们应该在这里去处理所有的耗时任务。
    任务一旦完成就可以通过return语句来将任务的执行结果进行返回，如果AsyncTask的第三个泛型参数指定的是Void，就可以不返回任务执行结果。注意，在这个方法中是不可以进行UI操作的，如果需要更新UI元素，比如说反馈当前任务的执行进度，可以调用publishProgress(Progress…)方法来完成。

  6. onProgressUpdate(Progress…)
    当在后台任务中调用了publishProgress(Progress…)方法后，这个方法就很快会被调用，方法中携带的参数就是在后台任务中传递过来的。在这个方法中可以对UI进行操作，在主线程中进行，利用参数中的数值就可以对界面元素进行相应的更新。

  7. onPostExecute(Result)
    当doInBackground(Params…)执行完毕并通过return语句进行返回时，这个方法就很快会被调用。返回的数据会作为参数传递到此方法中，可以利用返回的数据来进行一些UI操作，在主线程中进行，比如说提醒任务执行的结果，以及关闭掉进度条对话框等

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
//执行顺序
//onPreExecute() --> doInBackground() --> publishProgress() --> onProgressUpdate() --> onPostExecute()
class DownloadTask extends AsyncTask<Void, Integer, Boolean> {  
  
    @Override  
    protected void onPreExecute() {  
        progressDialog.show();  
    }  
  
    @Override  
    protected Boolean doInBackground(Void... params) {  
        try {  
            while (true) {  
                int downloadPercent = doDownload();  
                publishProgress(downloadPercent);  
                if (downloadPercent >= 100) {  
                    break;  
                }  
            }  
        } catch (Exception e) {  
            return false;  
        }  
        return true;  
    }  
  
    @Override  
    protected void onProgressUpdate(Integer... values) {  
        progressDialog.setMessage("当前下载进度：" + values[0] + "%");  
    }  
  
    @Override  
    protected void onPostExecute(Boolean result) {  
        progressDialog.dismiss();  
        if (result) {  
            Toast.makeText(context, "下载成功", Toast.LENGTH_SHORT).show();  
        } else {  
            Toast.makeText(context, "下载失败", Toast.LENGTH_SHORT).show();  
        }  
    }  
}

Tips

  1. 异步任务的实例必须在UI线程中创建，即AsyncTask对象必须在UI线程中创建。

  2. execute(Params… params)方法必须在UI线程中调用。

  3. 不要手动调用onPreExecute()，doInBackground(Params… params)，onProgressUpdate(Progress… values)，onPostExecute(Result result)这几个方法。

  4. 不能在doInBackground(Params… params)中更改UI组件的信息。

  5. 一个任务实例只能执行一次，如果执行第二次将会抛出异常。